home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / catn100.zip / CATNODE.DOC < prev    next >
Text File  |  1992-10-17  |  10KB  |  258 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.         CATNODE! v1.00
  13.  
  14.         Nodelist Processor for WILDCAT! v3.+
  15.  
  16.         (c) Copyright 1992 by Dale Barnes, All Rights Reserved
  17.  
  18.         Fidonet 1:3601/14.20
  19.  
  20.  
  21.  
  22.  
  23.  
  24.         Table of Contents                                         Page
  25.         ~~~~~~~~~~~~~~~~~                                         ~~~~
  26.  
  27.         Introduction .............................................   1
  28.  
  29.         Features .................................................   1
  30.  
  31.         Files Included ...........................................   1
  32.  
  33.         Copyrights ...............................................   1
  34.  
  35.         Disclaimer ...............................................   1
  36.  
  37.         Installation .............................................   2
  38.  
  39.         Usage ....................................................   2
  40.  
  41.         Control File .............................................   3
  42.  
  43.         Thanks! ..................................................   4
  44.  
  45.         Registration .............................................   4
  46.  
  47.         Technical Support ........................................   4
  48.  
  49.         History ..................................................   4
  50.  
  51.  
  52.                                             CATNODE Reference Manual  Pg  1
  53.  
  54.         Introduction
  55.         ~~~~~~~~~~~~
  56.  
  57.         CATNODE is used to create the needed database files that WILDCAT!
  58.         needs to properly allow the use of the Netmail features.  CATNODE
  59.         currently only supports the Fidonet compatible St. Louis style raw
  60.         text nodelists.
  61.  
  62.  
  63.         Features
  64.         ~~~~~~~~
  65.  
  66.         1) Ability to ABORT at any time during a NODELIST compile.  Just
  67.            press the ESC key and this will stop at the current position
  68.            but you should still be able to use what has been compiled but
  69.            it allows you to stop and reconfigure quickly.
  70.  
  71.         2) Status bar showing current action and percentage of its completion.
  72.  
  73.         3) Shows what ZONES and NODE address that have been defined in the
  74.            control file.
  75.  
  76.         4) Merge ability - Allows you to MERGE almost any St. Louis format
  77.            nodediff file to the proper nodelist file.
  78.  
  79.         5) Define your primary nodelist.  See the section on the control
  80.            file for more details.
  81.  
  82.  
  83.         Files Included:
  84.         ~~~~~~~~~~~~~~~
  85.         CATNODE.EXE  - Plain version, runs on any MSDOS, IBM compatible machine
  86.         CATNODE.CFG  - Sample configuration file
  87.         CATNODE.DOC  - This Document
  88.  
  89.  
  90.         Copyrights
  91.         ~~~~~~~~~~
  92.         CATNODE is Copyrighted by Dale Barnes and Majik Micro Systems
  93.         WildNode! is Copyrighted by Online Computer Resources
  94.         WILDCAT! is Copyrighted by Mustang Software Inc.
  95.         IBM is a trademark of International Business Machines
  96.         Fidonet is a trademark of Tom Jennings
  97.         MSDOS is a trademark of Microsoft Corporation
  98.  
  99.         Disclaimer
  100.         ~~~~~~~~~~
  101.         I only guarantee that this program will take space.  Use at your own
  102.         risk.  Neither the author nor any other person, corporation or
  103.         organization involved in it's distribution will not be held responsible
  104.         for any damage of any kind from the use of this program.
  105.  
  106.         The author is not responsible for any damage, lost profits from the
  107.         use of or the inability to use this program.  The entire risk of using
  108.         this package will remain with you, the end user.
  109.  
  110.  
  111.                                             CATNODE Reference Manual  Pg  2
  112.  
  113.         INSTALLATION
  114.         ~~~~~~~~~~~~
  115.         The setup for this program is quite simple.  Before installing
  116.         CATNODE, you must have already installed WILDCAT!.
  117.  
  118.         There are two different approaches you can take with CATNODE. The
  119.         first is to place the CATNODE.EXE and the CATNODE.CFG file in
  120.         the data directory as defined in the MAKEWILD config program. The
  121.         second way is to use WILDCAT!'s environment variable "WCNODELIST" to
  122.         tell both WILDCAT! and CATNODE where to find/place the nodelist files.
  123.  
  124.         For more information on the nodelist variable, please refer to the
  125.         WILDCAT! docs.
  126.  
  127.         1)  Place the CATNODE files in the same directory as your raw
  128.             nodelist files and where your WILDCAT! nodelist files are
  129.             suppose to be as defined in MAKEWILD.  You can run CATNODE
  130.             from this directory or use option #2.
  131.  
  132.         2)  CATNODE can use the WCNODELIST DOS environment variable
  133.             and place CATNODE.EXE on any path defined via the SET PATH
  134.             statement.  Your CATNODE.CFG, raw nodelist files and the
  135.             WILDCAT! nodelist files will need to be where WCNODELIST
  136.             points to.  Also this is where your WILDNODE.DAT/IX files
  137.             will be placed.
  138.  
  139.             YOU MUST MAKE SURE that the trailing backslash is used:
  140.  
  141.             Example:  Set WCNODELIST=E:\WC30\DATA\
  142.  
  143.             CATNODE does not require the trailing backslash but I
  144.             guess WILDCAT! or other utilities might.
  145.  
  146.  
  147.         Usage
  148.         ~~~~~
  149.  
  150.         CATNODE can be placed in any pathed directory or make sure the
  151.         current directory is where you want the data files stored unless
  152.         you are using the WCNODELIST enviroment variable.
  153.  
  154.         Commandline options:
  155.  
  156.         /C  -  Clean up, using this option the command line will tell
  157.                CATNODE to delete any prev week nodelist if the current
  158.                nodelist is compiled and/or any diff file, if a merge
  159.                is completed.
  160.  
  161.         /M  -  Merge all diff files found.  If this option is not used
  162.                then no updating of the nodelist will take place even if
  163.                the proper diff file exists.
  164.  
  165.                                             CATNODE Reference Manual  Pg  3
  166.  
  167.         Control File
  168.         ~~~~~~~~~~~~
  169.         Now we must edit the CATNODE.CFG file.  A Example is listed below:
  170.  
  171.         Default_List <nodelist name> <diff name>
  172.         Node 1:3601/14.20
  173.         Zones 1 5 6
  174.         Pvtlist dbnet  <diff name>
  175.         Country 1
  176.         Cost  11  125
  177.             1-415-   4
  178.             1-916-   9
  179.             1-707-   11
  180.         End
  181.  
  182.  
  183.         Default_List - This option allow you to tell CATNODE what the primary
  184.                        nodelist you will be using.  The default is NODELIST for
  185.                        the FidoNet network.  No extension is needed since CATNODE
  186.                        always looks for the most up to date list available.
  187.  
  188.         Node         - This is your network address of your system.  This option
  189.                        is not really needed currently but I may have a use for this
  190.                        in the future.
  191.  
  192.         Zones        - Tells CATNODE what ZONES to include in the finished nodelist
  193.                        files.  ZONE 1 is North America so if ZONE 1 is the only information
  194.                        you require, then list only that zone after the key word.  If you
  195.                        omit this, then all zones will be included.
  196.  
  197.         PvtList      - If you are using other network nodelist or private nodelists, then
  198.                        you will need to use this option.
  199.  
  200.                        If using other network nodelists that adhere to the Fidonet specs
  201.                        for raw nodelists, then you can just list the name of the other
  202.                        network nodelist with no extension and it will be included.  CATNODE
  203.                        can also merge any PvtList diff files to the main PvtList file as long
  204.                        as it adheres to FidoNet specs.  Another network using "MAILLIST" would
  205.                        be for example:
  206.  
  207.                            PvtList MAILLIST  MAILDIFF
  208.  
  209.                        The second parameter tells what diff name to scan for updated lists.
  210.  
  211.         Country      - This is the long distance dialing code for the country you
  212.                        live.  Please refer to your phone book for country codes.
  213.  
  214.         Cost         - This controls the cost of the netmail message.  The first
  215.                        line has three parameters:  COST <domestic cost> <int'l cost>.
  216.                        Domestic cost is ther cost within your country, Int'l cost is
  217.                        any call outside your country code.
  218.  
  219.                        CATNODE will continue to read the cost information until a END
  220.                        is found.  There are two parameters required between the first
  221.                        line and the END.  They are as follows:
  222.  
  223.                        <Phone Prefix>  <Cost>
  224.  
  225.                        Phone Prefix can be any part of a phone number, from just the 1-
  226.                        to 1-305-999-5555 and assign the cost of <Cost> to that number.
  227.  
  228.                                             CATNODE Reference Manual  Pg  4
  229.  
  230.  
  231.         Thanks!
  232.         ~~~~~~~
  233.         I would like to take a moment to personally thank Lee Fisher for helping
  234.         me test this program to the fullest.  When I asked of those using my
  235.         program for bug reports, Lee was always there.  Thanks Lee!
  236.  
  237.  
  238.         Registration
  239.         ~~~~~~~~~~~~
  240.         Free, no charge.
  241.  
  242.  
  243.         Technical Support
  244.         ~~~~~~~~~~~~~~~~~
  245.         Technical support is available via Fidonet conference WILDCAT.  Netmail
  246.         can be sent to Dale Barnes at 1:3601/14.20.  I will attempt to answer
  247.         all questions but the WILDCAT echo would be the best place to get support
  248.         questions answered.
  249.  
  250.  
  251.         History
  252.         ~~~~~~~
  253.         v1.00 - Released 10/17/92
  254.  
  255.  
  256.  
  257.  
  258.